SaveEntries

SaveEntries
Header:	Quickdraw.h		Carbon status:	Supported

Saves a selection of color table entries. This function is used by system software and your application should not need to call it.

void SaveEntries (
    CTabHandle srcTable, 
    CTabHandle resultTable, 
    ReqListRec *selection
);

Parameter descriptions

srcTable: The color table containing entries to be saved.If you supply NULL, SaveEntries uses the current device’s color table as the source.
resultTable: The color table in which to save the entries.
selection: A pointer to the ReqListRec data structure. The entries to be set are enumerated as offsets into a ColorTable data structure, not the contents of the ColorSpec.value field.) If an entry is not present in srcTable, then SaveEntries sets that position of the selection parameter to colReqErr, and that position of resultTable contains random values.

DISCUSSION

If SaveEntries can not find one or more entries, then it posts an error code to QDError; however, for every entry in selection which is not colReqErr, the values in resultTable are valid. SaveEntries assumes that the color table specified by the srcTable parameter and the request list specified by the selection parameter have the same number of entries.

The output of SaveEntries is the same as the input for RestoreEntries, except for the order.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.